📘 Bonnes pratiques – VISION (Visionsoft)

Une bonne application no-code ne suffit pas.
Une application maintenable, évolutive et compréhensible fait toute la différence.

VISION, la solution no-code ultra performante de Visionsoft, permet de créer des applications métiers sans limite (GMAO, MES, Supply Chain, BIM, etc.).
Pour garantir la pérennité des projets, voici les bonnes pratiques recommandées.

1️⃣ Un modèle de données (SmartObjects) clair

Un modèle clair = un projet compréhensible dans le temps.

✅ À faire

• Donner un nom métier clair à chaque SmartObject
• Définir chaque champ :
• Type
• Obligatoire / facultatif
• Valeur par défaut
• Préciser les dépendances avec d’autres applications

🎯 Bon exemple

Équipement

• Description : Entité représentant un actif maintenable.
• Champs :
• nom (string, obligatoire)
• date_mise_en_service (date)

❌ À éviter

• Champs nommés : champ1, data2
• Relations implicites non documentées

2️⃣ Documenter les processus (Workflows)

Les workflows sont le cœur de la logique métier.

✅ À faire

• Décrire l’objectif du workflow en utilisant les blocs
• Regrouper les principales étapes en plusieurs blocs logiques
• Détailler :
• Les étapes principales
• Les règles de décision
• Les notifications envoyées
• Les impacts sur les données

🎯 Exemple

Workflow : Validation d’un ordre de travail

1. Soumission par le technicien
2. Vérification des pièces
3. Validation responsable
4. Changement de statut → Planifié

3️⃣ Documenter les Smartflows (Intégrations & Automatisations)

Les Smartflows orchestrent les échanges de données.

✅ À documenter

• Source de données (API, ERP, GMAO, CSV…)
• Règles de transformation
• Gestion des erreurs

4️⃣ Documenter l’interface utilisateur (UI Composer)

L’UI doit être compréhensible sans ouvrir le studio.

✅ À inclure

• Objectif de chaque écran
• Règles d’affichage conditionnel
• Logique des boutons d’action

5️⃣ Documenter les règles métier

Les règles métier ne doivent jamais être implicites.

Exemples

• Un OT ne peut être clôturé si une NC est ouverte
• Une consommation matière doit être liée à un OF
• Une VGP ne peut être générée que si l’équipement est actif

Pour chaque règle, documenter :

• La règle dans le workflow ou dans le bouton d'appel si besoin

6️⃣ Utiliser VISION AI pour documenter plus vite

Grâce à VISION AI, il est possible de :

• Générer automatiquement une description de modèle
• Produire un résumé fonctionnel
• Générer une cartographie des objets
• Transformer une documentation en base de connaissances

De plus, chaque workflow ou écran généré avec l'IA garde l'historique des prompts, ce qui en fait une base de documentation idéale.